home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / fredd.arc / FREDD.DOC < prev    next >
Encoding:
Text File  |  1983-07-29  |  10.2 KB  |  287 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                          FRED EDITOR REFERENCE V1.21
  7.  
  8.                          (c) 1983 by David N. Smith
  9.                              44 Ole Musket Lane
  10.                               Danbury, CT 06810
  11.                                 28 July 1983
  12.  
  13.  
  14.  
  15.  
  16.      FRED is the FRee EDitor.  It is distributed under  the  "freeware
  17.      concept" which means that you do not have to pay for it.  You can
  18.      copy  it,  give  it away, or do anything else with it except sell
  19.      it.  If you find  that it is very useful, you are invited to make
  20.      a donation or contribution to the author of $20 to help reimburse
  21.      him for his time and effort and  to  encourage  him to write more
  22.      free software.
  23.  
  24.      FRED comes with no warranties of any kind; it is available AS IS.
  25.      The author, uh, I would  like to know of problems that users have
  26.      but  makes no promise or guarantees  that  any  problem  will  be
  27.      fixed.  I have no plans for extensions  to FRED.  There are a lot
  28.      of fine editors out there  for $100 to $150; if your needs exceed
  29.      FRED, I suggest that you look at some of these.
  30.  
  31.  
  32.  
  33.      ABOUT FRED
  34.  
  35.      FRED is a full screen editor for the IBM PC.   It  displays files
  36.      up to 1500 lines long and with lines up to 254 characters long on
  37.      a monochrome display  or  80 column graphics display.  The screen
  38.      is a window onto the  file.   The  window can move up, down, left
  39.      and right.  Lines  which  are  longer  than the screen are partly
  40.      displayed.  If you insert data, characters seem to be lost off of
  41.      the  end of the line; they are not lost but are  just  no  longer
  42.      displayed.   Move  the cursor off of the screen to the right  and
  43.      they will reappear as the window moves.
  44.  
  45.      If a file is too big to fit into memory,  it  complains politely;
  46.      if  memory nears the limit while you are editing, FRED tells  you
  47.      and lets you continue editing  but  won't let you add more lines.
  48.      In general, it is forgiving; you can even remove the  diskette it
  49.      is reading from or writing to without bombing it or loosing  data
  50.      in memory but I do not recommend it (nor guarantee it).
  51.  
  52.      It  updates  the  display buffer directly so that screen  updates
  53.      appear  instantaneous;  it  is fully possible to scroll through a
  54.      file at typamatic speeds.
  55.  
  56.      FRED is written in about 590 lines of compiled BASIC and about 30
  57.      lines of assembler.  Since  its performance is horrid except when
  58.  
  59.  
  60.                                    - 2 -
  61.  
  62.  
  63.      compiled, source is not distributed.
  64.  
  65.      FRED is similar to the IBM Personal Editor; most of it's keys are
  66.      the  same  and  its  approach to handling the screen is about the
  67.      same.   I  use  the Personal Editor;  FRED was an experiment from
  68.      some time ago which I had  laid aside.  Several months of reading
  69.      the dialogs  on  the  IBM PC Special Interest Group on CompuServe
  70.      convinced  me  that there are many people out there who still use
  71.      EDLIN and who will never pay $100 for an editor.  Therefore I got
  72.      FRED out and polished  it  up  a bit  to  give away.  I hope that
  73.      people find it useful.
  74.  
  75.      The documentation is somewhat sparse; there is  no  tutorial  and
  76.      little  else  but a list of keys.  I suspect that most  PC  users
  77.      won't have any trouble using  it  since  most  of the keys do the
  78.      "right" thing.
  79.  
  80.      If you want to  try  it immediately, remember that F1 puts you in
  81.      command mode  and  displays  a list  of the commands and that F10
  82.      describes the other function keys; then just start trying things.
  83.  
  84.  
  85.  
  86.      FRED FILES
  87.  
  88.      The following files are a part of the FRED package.  According to
  89.      where you  get  FRED  you may get more or less of them.  Only the
  90.      first two are needed to run FRED.
  91.  
  92.           Filename      Contents
  93.           ------------  --------------------------------------------
  94.           FRED.DOC      A ready-to-print FRED document
  95.                         (what you are reading now)
  96.           FRED.EXE      The FRED Program
  97.           FREDDIE.EXE   The FRED Program but compiled to use
  98.                         BASRUN.EXE; it is thus much smaller.
  99.                         (BASRUN.EXE comes with the BASIC compiler.)
  100.           FRED.HEX      A transportable version of FRED.EXE
  101.                         found on some interactive systems.
  102.                         You run CVTHEX to make FRED.EXE.
  103.                         (CVTHEX is also on the interactive system.)
  104.           FRED.GET      A short note about how to get FRED
  105.                         found on some interactive systems.
  106.           FRED.SUM      A summary of FRED features.
  107.  
  108.  
  109.                                    - 3 -
  110.  
  111.  
  112.      STARTING FRED
  113.  
  114.      Type  FRED.  When FRED loads it will ask for the name of the file
  115.      to edit.  If the file  cannot  be  found, it is assumed to be new
  116.      and an empty file with that name is edited.  It does not exist on
  117.      disk until you file it.
  118.  
  119.  
  120.  
  121.      FRED COMMANDS
  122.  
  123.      Commands  are  entered  only after pressing the F1 key.  Commands
  124.      may  be   typed   in   upper-  or  lowercase;  in  the  following
  125.      descriptions, uppercase is used for command names  and  lowercase
  126.      for operands.
  127.  
  128.      SAVE
  129.           Save  the  file  to  disk.   The  new  file  is  written  as
  130.           FREDFRED.TMP.  Then the old file is renamed FREDFRED.BAK and
  131.           FREDFRED.TMP  is  renamed  with  the   right   name.    Then
  132.           FREDFRED.BAK  is  erased.   This  process  assures that that
  133.           there is always one correct copy of the  file  on  the disk.
  134.           However,  it  does require enough working space to hold  the
  135.           largest file to be edited.
  136.  
  137.      QUIT (or 'Q')
  138.           Quit editing.  If the file has been  changed,  you  will  be
  139.           prompted for a 'y' before FRED really quits.
  140.  
  141.      /string/
  142.  
  143.      .string.
  144.           Locate the string between the slashes or dots.  The trailing
  145.           slash  or  dot can be omitted  unless  trailing  blanks  are
  146.           important.  The string can contain slashes or dots.
  147.  
  148.      NAME fileid
  149.           Give the file a new name.
  150.  
  151.  
  152.                                    - 4 -
  153.  
  154.  
  155.      FRED KEYS
  156.  
  157.  
  158.      The following list defines the meaning of each key when  in  full
  159.      screen mode.  When the command prompt is  up,  normal  BASIC line
  160.      editing is in effect.
  161.  
  162.      Alt-d
  163.           Delete a marked area; see Alt-l for more information.
  164.  
  165.      Alt-j
  166.           Join the next line onto the current one at the end.
  167.  
  168.      Alt-l
  169.           Mark  the  current  line or extend a marked line.  The first
  170.           Alt-l marks  a line  and  displays it in reverse video.  The
  171.           second  marks  all  lines  from  the  first  one through the
  172.           second.  Further Alt-l keystrokes extend the marked  area to
  173.           the current line (or shrink it from the nearest edge).
  174.  
  175.           Marked areas  may  be  copied or deleted.  See Alt-d, Alt-u,
  176.           and Alt-z.
  177.  
  178.      Alt-s
  179.           Split  the  current  line  into two parts at the cursor.  At
  180.           column  one  this adds a new lines before the  current  one;
  181.           this is how you put a new line ahead of the first one.
  182.  
  183.      Alt-u
  184.           Unmark an area; see Alt-l.
  185.  
  186.      Alt-z
  187.           Copy a marked area to just after the current line.  A marked
  188.           area cannot  be moved into itself.  (The choice of Alt-z for
  189.           this function comes from the IBM Personal Editor.)
  190.  
  191.      Backspace
  192.           Backspace over and delete the previous character.
  193.  
  194.      Character keys, shifted or unshifted.
  195.           Enter the character into the  current  line.   If  in insert
  196.           mode, put it at the cursor position and slide the characters
  197.           under  and  to  the right of the cursor to the right.  If in
  198.           replace mode, replace the character under the cursor.
  199.  
  200.      Ctrl-End
  201.           Position the cursor on the  last  line of the file.  Keep it
  202.           in the same column.
  203.  
  204.  
  205.                                    - 5 -
  206.  
  207.  
  208.      Ctrl-Home
  209.           Position the cursor on the top line of the file.  Keep it in
  210.           the same column
  211.  
  212.      Ctrl-Left
  213.           Move the cursor to the left 40 positions.
  214.  
  215.      Ctrl-Pg Dn
  216.           Position the cursor  at the bottom edge of the screen (or on
  217.           the last line of the file if encountered first).  The column
  218.           position is unchanged.
  219.  
  220.      Ctrl-Right
  221.           Move the cursor to the right 40 positions.
  222.  
  223.      Cursor keys (arrows on numeric keypad)
  224.           Move the cursor up, down,  left,  or right one position.  If
  225.           the cursor would move off  of  the  screen in a direction in
  226.           which  there  is  more  data, then  scroll  the  screen  one
  227.           character in that direction.
  228.  
  229.      Del
  230.           Delete the character under the cursor.
  231.  
  232.      End
  233.           Position the cursor at the end of current line.
  234.  
  235.      Enter key
  236.           Put  a new  line  in the file and position the cursor at the
  237.           front of it.  (Also see Alt-J.)
  238.  
  239.      F1
  240.           Enter  command  mode.   A list of the  allowed  commands  is
  241.           displayed.
  242.  
  243.      F2
  244.           Repeat the most recent locate command (see the "/" command).
  245.  
  246.      F5
  247.           Clear the current line  and  position the cursor at the left
  248.           edge.
  249.  
  250.      F6
  251.           Clear the current line under and to the right of the cursor.
  252.  
  253.      F10
  254.           Display what the other function keys do.
  255.  
  256.  
  257.  
  258.                                    - 6 -
  259.  
  260.  
  261.      Home
  262.           Position the cursor in the first  column of both the current
  263.           file line and the screen.
  264.  
  265.      Ins
  266.           Toggle  between  insert  and replace modes.  The status line
  267.           describes which is in effect.
  268.  
  269.      Pg Dn
  270.           Scroll down 20 lines.
  271.  
  272.      Pg Up
  273.           Scroll up 20 lines.
  274.  
  275.      Shift-F4
  276.           Undo a change to the current line.  Once the cursor is moved
  277.           from the line the change cannot be undone with this key.
  278.  
  279.      Shift-F8
  280.           Delete the line at the cursor.  The cursor moves to the next
  281.           line in the file.
  282.  
  283.      Tab
  284.           Tab right  to  the  beginning  of the next word.  (Words are
  285.           groups of characters separated by blanks.)
  286.  
  287.